From 3050f437c5505f7fde4d06dcff88664de260150e Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 18 Dec 2003 00:39:17 +0000 Subject: [PATCH] Correct misleading docs. Add docs for the "activate" signal. (#129358, Thu Dec 18 01:37:59 2003 Matthias Clasen * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs. * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the "activate" signal. (#129358, Ka-Hing Cheung) --- ChangeLog | 6 ++++++ ChangeLog.pre-2-10 | 6 ++++++ ChangeLog.pre-2-4 | 6 ++++++ ChangeLog.pre-2-6 | 6 ++++++ ChangeLog.pre-2-8 | 6 ++++++ gtk/gtkbutton.c | 9 +++++++++ gtk/gtkwidget.c | 5 ++--- 7 files changed, 41 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 52ce513608..d3f2a17ce5 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Thu Dec 18 01:37:59 2003 Matthias Clasen + + * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs. + * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the + "activate" signal. (#129358, Ka-Hing Cheung) + Thu Dec 18 01:21:59 2003 Kristian Rietveld * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 52ce513608..d3f2a17ce5 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,9 @@ +Thu Dec 18 01:37:59 2003 Matthias Clasen + + * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs. + * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the + "activate" signal. (#129358, Ka-Hing Cheung) + Thu Dec 18 01:21:59 2003 Kristian Rietveld * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 52ce513608..d3f2a17ce5 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,9 @@ +Thu Dec 18 01:37:59 2003 Matthias Clasen + + * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs. + * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the + "activate" signal. (#129358, Ka-Hing Cheung) + Thu Dec 18 01:21:59 2003 Kristian Rietveld * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 52ce513608..d3f2a17ce5 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,9 @@ +Thu Dec 18 01:37:59 2003 Matthias Clasen + + * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs. + * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the + "activate" signal. (#129358, Ka-Hing Cheung) + Thu Dec 18 01:21:59 2003 Kristian Rietveld * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 52ce513608..d3f2a17ce5 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,9 @@ +Thu Dec 18 01:37:59 2003 Matthias Clasen + + * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs. + * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the + "activate" signal. (#129358, Ka-Hing Cheung) + Thu Dec 18 01:21:59 2003 Kristian Rietveld * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c index 6a7269f5ef..d543e36088 100644 --- a/gtk/gtkbutton.c +++ b/gtk/gtkbutton.c @@ -316,6 +316,15 @@ gtk_button_class_init (GtkButtonClass *klass) NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); + + /** + * GtkButton::activate: + * + * The "activate" signal on GtkButton is an action signal and + * emitting it causes the button to animate press then release. + * Applications should never connect to this signal, but use the + * "clicked" signal. + */ button_signals[ACTIVATE] = g_signal_new ("activate", G_OBJECT_CLASS_TYPE (object_class), diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 9c66beccc5..b6d45ea85f 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -3557,9 +3557,8 @@ gtk_widget_event_internal (GtkWidget *widget, * * For widgets that can be "activated" (buttons, menu items, etc.) * this function activates them. Activation is what happens when you - * press Enter on a widget during key navigation; clicking a button, - * selecting a menu item, etc. If @widget isn't activatable, - * the function returns %FALSE. + * press Enter on a widget during key navigation. If @widget isn't + * activatable, the function returns %FALSE. * * Return value: %TRUE if the widget was activatable **/ -- 2.30.2